home *** CD-ROM | disk | FTP | other *** search
/ Aminet 13 / Aminet 13 - August 1996.iso / Aminet / gfx / conv / WhirlGIF20.lha / WhirlGIF / WhirlGIF.doc < prev   
Text File  |  1996-03-03  |  2KB  |  67 lines
  1. WhirlGIF 2.00
  2.  
  3. whirlgif is a quick program that reads a series of GIF files, and produces
  4. a single gif file composed of those images.
  5.  
  6. Usage:
  7.     whirlgif [-v] [-trans index ] [-time delay] [-o outfile]
  8.          [-loop] [-i incfile] file1 [ -time delay] file2
  9.  
  10. options:
  11.         -v           verbose mode    
  12.         -loop [count]    add the Netscape 'loop' extension.
  13.         -time delay    inter-frame timing.
  14.         -trans index    set the colormap index 'index' to be transparent
  15.         -o outfile    write the results to 'outfile'
  16.         -i incfile    read a list of names from 'incfile'
  17.  
  18. TIPS
  19.  
  20. If you don't specify an output file, the GIF will be sent to stdout. This is
  21. a good thing if you're using this in a CGI script, a very bad thing if you
  22. run this from a terminal and forget to redirect stdout.
  23.  
  24. The output file (if any) and -loop _MUST_ be specified before any gif images.
  25.  
  26. You can specify several delay statements on the command line to change
  27. the delay between images in the middle of an animation, e.g.
  28.  
  29.     whirlgif -time 5 a.gif b.gif c.gif -time 100 d.gif -time 5 e.gif f.gif
  30.  
  31. Although it's generally considered to be evil, you can also specify
  32. several transparency statements on the command line, to change the transparent
  33. color in the middle of an animation. This may cause problems for some programs.
  34.  
  35.  
  36. BUGS
  37.  
  38.    + The loop 'count' is ineffective because Netspcape always loops infinitely.
  39.  
  40.    + should be able to specify delay in an 'incfile' list (see next bug).
  41.  
  42.    + Does not handle filenames starting with a - (hypen), except in 'incfile'.
  43.  
  44.    + Needs better documentation.
  45.  
  46.  
  47. TODO
  48.  
  49.    + Only save colormaps that are different from preceeding ones.
  50.  
  51.    + have an option that compares current image with previous and then
  52.      only save the smallest rectangle that encompasses changes. I need sample
  53.      code- the most efficient algorithms are patented?
  54.  
  55.    + option for luma sorting of colormaps
  56.  
  57.    + define extension block in order to have frame lists.
  58.  
  59.  
  60. This program is available from http://www.msg.net/utility/whirlgif/
  61.  
  62. --------------------------
  63. Kevin Kadow    kadokev@msg.net
  64.  
  65. Based on 'txtmerge' written by:
  66. Mark Podlipec    podlipec@wellfleet.com
  67.